home *** CD-ROM | disk | FTP | other *** search
/ Fritz: All Fritz / All Fritz.zip / All Fritz / FILES / GRAPTIES / ANOTHER1.LZH / TMWPART1.EXE / lha / RUNTIME.DOC < prev    next >
Text File  |  1992-08-28  |  11KB  |  233 lines
  1.  
  2.          ******************* THE RUN-TIME PROGRAM ********************
  3.  
  4.              There is a run-time  program  included  in  this  kit  to
  5.          display  multimedia  pictures  created  with  The  Multimedia
  6.          Workshop. In most cases, you will want  to  include  it  with
  7.          your  pictures  on disks that you distribute, so that the end
  8.          users will be able to use your  pictures.   Registered  users
  9.          are  free  to  distribute the run-time program MSHOW.EXE with
  10.          their products.
  11.  
  12.              MSHOW  runs  in  either  of   two   modes,   "batch"   or
  13.          "presentation"  mode.  In batch mode, it displays one picture
  14.          complete with sound effects, etc, then waits for the user  to
  15.          press   any   key   before  returning  control  to  DOS.   In
  16.          presentation mode, it displays a series of picture files  and
  17.          presents  the  end  user  with  a  menu  from  which the user
  18.          controls the presentation.
  19.  
  20.              When MSHOW starts,  it  looks  to  see  if  there  is  an
  21.          accompanying  picture  file  name  typed at the DOS prompt or
  22.          provided in the batch file from which  you  may  have  called
  23.          MSHOW.  If  found,  MSHOW  displays  that  picture file, then
  24.          returns to DOS.
  25.  
  26.              If there is no picture  file  listed  with  the  call  to
  27.          MSHOW,  it looks for a special file on disk called MSHOW.CFG,
  28.          which is created with the BUILD option on the The  Multimedia
  29.          Workshop  control  panel.  If it finds MSHOW.CFG then it runs
  30.          in presentation mode, using the group of picture files listed
  31.          in the MSHOW.CFG file.
  32.  
  33.              In  presentation  mode,  at  the  bottom  of  this  first
  34.          picture  is  a  small  menu  allowing the user to take one of
  35.          several actions.  They are:
  36.  
  37.          ┌──────┬──────┬──────┬────────┬──────┬──────┬────────┬──────┐
  38.          │ HELP │ BACK │ NEXT │ RESUME │ AUTO │ GOTO │ SEARCH │ QUIT │░
  39.          └──────┴──────┴──────┴────────┴──────┴──────┴────────┴──────┘░
  40.            ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  41.  
  42.  
  43.              These options can be selected with  the  left  and  right
  44.          arrow  keys  then a press of the [Enter] key, by pressing the
  45.          first letter of the menu item, or a sideways movement of  the
  46.          mouse then a click of the left button.
  47.  
  48.          HELP displays a single screen of information about how to use
  49.          the menu (although quite unnecessary!)
  50.  
  51.          BACK shows the previous picture viewed.
  52.  
  53.          NEXT shows the next picture in your presentation,
  54.  
  55.          RESUME displays the last picture viewed during the last  time
  56.          MSHOW was used.  It does this by writing a small file to disk
  57.          containing the number of the picture currently displayed when
  58.          the  user quits the MSHOW program.  The next time the program
  59.          is started, if the user selects RESUME, it  reads  that  file
  60.          and  finds the picture so the user can continue from where he
  61.          left off.
  62.  
  63.          AUTOmate  is to display your presentation over and over again
  64.          automatically.  When selected,  MSHOW  asks  you  to  type  a
  65.          number  of  seconds. It will pause for that long between each
  66.          picture.  When  it  comes  to  the  last  picture   in   your
  67.          presentation,   it  will  start  all  over  again.   This  is
  68.          excellent for  trade  show  displays,  retailers  can  put  a
  69.          monitor  in  their  store  windows at night advertising their
  70.          products, computer  retailers  can  leave  MSHOW  running  on
  71.          computers  in  their  stores. A student at a science fair can
  72.          create a show about her project and display it at her table.
  73.  
  74.          GOTO is an electronic Table of Contents. When  selected,  the
  75.          end  user is presented with a picture of a Table of Contents,
  76.          and can type a number, and then  be  taken  to  that  picture
  77.          within your presentation.  This is optional and requires that
  78.          you make a special picture called GOTO.  If  MSHOW  does  not
  79.          find  a GOTO file, it merely ignores the GOTO request without
  80.          harm.  Making a GOTO picture is easy, and I'll tell  you  all
  81.          about it in a couple of minutes.
  82.  
  83.          SEARCH (called FIND when in the CGA-LO video mode) allows the
  84.          end  user  to  type  a word or phrase.  Then, starting at the
  85.          beginning of your presentation and working to the end,  MSHOW
  86.          quickly  searches  each picture file for that word or phrase.
  87.          If found, the picture is displayed on the screen and a  small
  88.          menu  appears to allow the end user to continue searching for
  89.          more occurrences, or return to the regular menu.  In addition
  90.          to selecting SEARCH with the mouse or menu bar, the user  can
  91.          press  [S] or [F] to begin a search.  As you might expect, it
  92.          works rather slowly when a big presentation is  on  a  floppy
  93.          disk.
  94.  
  95.                                      QUIT
  96.  
  97.          This is the way out to DOS.
  98.  
  99.                                  USER CONTROL
  100.  
  101.          New since version 4.0 are two  invisible  features:  The  end
  102.          user  can  stop  a  presentation  at any time by pressing the
  103.          [Esc] key.  The user is offered an opportunity  to  Quit  the
  104.          script  early.  Whatever script has not been played yet, will
  105.          not  be  displayed.  In  presentation  mode the menu bar will
  106.          return. In batch mode, the next keypress returns  control  to
  107.          DOS or the calling batch file.
  108.  
  109.          In  animation  loops,  the end user can press any key to stop
  110.          the loop.
  111.  
  112.  
  113.          **************************  NOTE  ***************************
  114.  
  115.          NOTE: All runtime programs used by your presentation must  be
  116.          copied  onto your final disk.  If you use synthesized speech,
  117.          PC-TALK.EXE and the speech files must be  copied  along  with
  118.          your script files.
  119.  
  120.             Also,  if  you use any fonts except the first two,  BITMAP
  121.          or  TRIPLEX, then the corresponding .CHR files must be copied
  122.          onto your finished disk.
  123.  
  124.          ******************** MAKING A GOTO FILE *********************
  125.  
  126.          This  is  optional.   The GOTO file is a special picture file
  127.          which is used by GOTO as a 'live table of contents.' The user
  128.          can type a number corresponding to any  of  the  pictures  in
  129.          your presentation, and be taken to that picture.
  130.  
  131.          First complete all the pictures in your presentation and  use
  132.          The  Multimedia  Workshop's  BUILD option to make a MSHOW.CFG
  133.          file. Make a note of the numbers to the left of  the  picture
  134.          files that will be key points in your presentation.
  135.  
  136.          To make the GOTO file, start a new picture file by  selecting
  137.          FILE from The Multimedia Workshop's control panel and call it
  138.          GOTO.   No  other  name  will  do,  and  it  cannot  have any
  139.          extension.  In this file, list or illustrate the key pictures
  140.          in your presentation and put a number next  to  them.   These
  141.          numbers  are  the number of the script file's position in the
  142.          menu.  The first script file is 1, and the second is 2,  etc.
  143.          In other words, if you have created a catalog of blacksmith's
  144.          tools,  and  you have several pictures of anvils, you need to
  145.          know the position of the first picture file of  an  anvil  in
  146.          your anvil section. This will be one of your goto points. You
  147.          can  have  as  many  goto points as you can fit onto the GOTO
  148.          picture.
  149.  
  150.          When  your  GOTO  picture is done, include it along with your
  151.          other  picture  files,   MSHOW.CFG   and   MSHOW.EXE   in   a
  152.          sub-directory or on a disk, then test it  by  running  MSHOW,
  153.          selecting  GOTO,  and  typing  the  numbers  for  the various
  154.          points, and make sure the pictures you expected  come  up  as
  155.          you planned.
  156.  
  157.          Note:  There is a sample GOTO file included on The Multimedia
  158.          Workshop disks for use  with  The  Multimedia  Workshop  Demo
  159.          Show.  Take a look at that GOTO picture to see how it's done.
  160.          To  see  another  example,  look  at  the  file  (temporarily
  161.          renamed)  GOTO.PEN  included  with  this program merely as an
  162.          example. GOTO.PEN requires VGA graphics.
  163.  
  164.  
  165.                                 RENAMING MSHOW
  166.  
  167.          Using the DOS command REN (Rename) you can  change  MSHOW.EXE
  168.          to  BEGIN.EXE  or GO.EXE, or you can make a batch file called
  169.          GO.BAT or START.BAT (etc) that starts MSHOW.  This  makes  it
  170.          easier for the end user to start your presentation.
  171.  
  172.                            USING MSHOW IN BATCH MODE
  173.  
  174.          Batch  mode  is  for  displaying  a single multimedia picture
  175.          along with its sound effects and animation, or for use within
  176.          batch files.  MSHOW will simply show a picture, then wait for
  177.          the user to press any key.  When a key is pressed, control is
  178.          returned to DOS.
  179.  
  180.          To use batch mode from the DOS prompt, type MSHOW,  a  space,
  181.          then  the  name of the picture file that you want to display.
  182.          For example:
  183.  
  184.             MSHOW C:\PICTURES\SPIDER.3
  185.  
  186.          or
  187.  
  188.             MSHOW SPIDER.4
  189.  
  190.          if your picture file is in the same place as MSHOW.EXE.
  191.  
  192.          If  you have a few pictures you want to display, and you want
  193.          to use a batch file to line them up,  you  can  do  something
  194.          like this:
  195.  
  196.          Make  a batch file called BEGIN.BAT, and in it, include these
  197.          lines:
  198.  
  199.          MSHOW SPIDER.1
  200.          MSHOW SPIDER.2
  201.          MSHOW SPIDER.3
  202.          MSHOW SPIDER.4
  203.  
  204.          When this batch file is run (when the  user  types  BEGIN)  a
  205.          picture  of  a  spider,  your  picture  called  SPIDER.1 will
  206.          appear.  When the user is through studying the  first  spider
  207.          and  presses  any key, your next spider picture, SPIDER.2, is
  208.          shown, and so on until all four pictures have been shown.
  209.  
  210.          And of course you can also use the batch file  to  run  other
  211.          programs, for instance:
  212.  
  213.          MSHOW MY_INTRO.PIC
  214.          MYPROG.EXE
  215.          MSHOW END.PIC
  216.  
  217.          The more you learn about batch files, the more things you can
  218.          do in the way of mixing and matching programs, picture files,
  219.          more  programs,  etc.  For instance, you could make a catalog
  220.          disk  which  is  mostly text, but in between displaying price
  221.          lists with a text presentation  program,  you  could  display
  222.          pictures of your more popular or interesting products.
  223.  
  224.          NOTE: If you have chosen any typefaces beyond the first  two,
  225.          BITMAP  and  TRIP,  within  The  Multimedia  Workshop,  their
  226.          corresponding disk file(s), *.CHR, must be copied  onto  your
  227.          presentation disks along with your picture files.
  228.  
  229.          _____________________________________________________________
  230.                                                         end of chapter
  231.  
  232.  
  233.